home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
standard
/
ldgetaux.z
/
ldgetaux
Wrap
Text File
|
1998-10-30
|
3KB
|
67 lines
LLLLDDDDGGGGEEEETTTTAAAAUUUUXXXX((((3333XXXX)))) LLLLDDDDGGGGEEEETTTTAAAAUUUUXXXX((((3333XXXX))))
NNNNAAAAMMMMEEEE
ldgetaux - retrieve an auxiliary entry, given an index
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmm....hhhh>>>>
####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
ppppAAAAUUUUXXXXUUUU llllddddggggeeeettttaaaauuuuxxxx((((LLLLDDDDFFFFIIIILLLLEEEE **** ldptr, iiiinnnntttt iaux ))));;;;
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_l_d_g_e_t_a_u_x returns a pointer to an auxiliary table entry associated with
_i_a_u_x. The AUXU is contained in a static buffer. Because the buffer can
be overwritten by later calls to _l_d_g_e_t_a_u_x, it must be copied by the
caller if the aux is to be saved or changed.
Note that auxiliary entries are not swapped as this routine cannot detect
what manifestation of the AUXU union is retrieved. If LDAUXSWAP(ldptr,
ldf) is non-zero, a further call to _s_w_a_p__a_u_x is required. Before calling
the _s_w_a_p__a_u_x routine, the caller should copy the aux.
If the auxiliary cannot be retrieved, _l_d_g_e_t_a_u_x returns NNNNUUUULLLLLLLL (defined in
<<<<ssssttttddddiiiioooo....hhhh>>>>) for an object file. This occurs when:
+o the auxiliary table cannot be found
+o the iaux offset into the auxiliary table is beyond the end of the
table
Typically, _l_d_g_e_t_a_u_x is called immediately after a successful call to
_l_d_t_b_r_e_a_d to retrieve the data type information associated with the symbol
table entry filled by _l_d_t_b_r_e_a_d. The index field of the symbol, pSYMR, is
the _i_a_u_x when data type information is required. If the data type
information for a symbol is not present, the index field is _i_n_d_e_x_N_i_l and
ldgetaux should not be called.
The program must be loaded with the object file access routine library
_l_i_b_m_l_d._a.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
ldclose(3X), ldopen(3X), ldtbseek(3X), ldtbread(3X), ldfcn(4).
PPPPaaaaggggeeee 1111